步骤 12:打包调试和发布¶
注意:此示例适用于单配置生成器,不适用于多配置生成器(如 Visual Studio)。
默认情况下,CMake 的模型是构建目录只包含单个配置,无论是 Debug、Release、MinSizeRel 还是 RelWithDebInfo。但是,可以设置 CPack 以捆绑多个构建目录,并构建一个包含同一项目多个配置的包。
首先,我们希望确保用于调试和发布构建的库使用不同的名称进行安装。让我们使用 d 作为调试库的后缀。
在顶级 CMakeLists.txt
文件的开头附近设置 CMAKE_DEBUG_POSTFIX
set(CMAKE_DEBUG_POSTFIX d)
add_library(tutorial_compiler_flags INTERFACE)
以及 tutorial 可执行文件上的 DEBUG_POSTFIX
属性
add_executable(Tutorial tutorial.cxx)
set_target_properties(Tutorial PROPERTIES DEBUG_POSTFIX ${CMAKE_DEBUG_POSTFIX})
target_link_libraries(Tutorial PUBLIC MathFunctions tutorial_compiler_flags)
我们还要向 MathFunctions
库添加版本编号。在 MathFunctions/CMakeLists.txt
中,设置 VERSION
和 SOVERSION
属性
set_property(TARGET MathFunctions PROPERTY VERSION "1.0.0")
set_property(TARGET MathFunctions PROPERTY SOVERSION "1")
从 Step12
目录中,创建 debug
和 release
子目录。布局将如下所示
- Step12
- debug
- release
现在,我们需要设置调试和发布构建。我们可以使用 CMAKE_BUILD_TYPE
设置配置类型
cd debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .
cd ../release
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
现在,调试和发布构建都已完成,我们可以使用自定义配置文件将这两个构建打包到单个发布版本中。在 Step12
目录中,创建一个名为 MultiCPackConfig.cmake
的文件。在此文件中,首先包含由 cmake
可执行文件创建的默认配置文件。
接下来,使用 CPACK_INSTALL_CMAKE_PROJECTS
变量来指定要安装的项目。在此例中,我们想要安装调试版本和发行版本。
include("release/CPackConfig.cmake")
set(CPACK_INSTALL_CMAKE_PROJECTS
"debug;Tutorial;ALL;/"
"release;Tutorial;ALL;/"
)
从 Step12
目录中,运行 cpack
,通过 config
选项指定我们的自定义配置文件
cpack --config MultiCPackConfig.cmake